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PREFACE 


This manual describes the features and operation of the File Utility 
Package for the PDP-11 Disk Operating System (DOS). Thus, the manual 
assumes familiarity with the DOS Monitor (see PDP-11 Disk Operating 
System Monitor, Programmer's Handbook, DEC-ll-MWDA-D) . 

The File Utility Package is called PIP (Peripheral Interchange 
Program) for compatibility with similar programs on other DEC systems 
Features provided by PIP include file transfers from one device to 
another, file deletions, file renaming, and directory listings. 

Appendix B, Helpful Hints, contains valuable information on pos 
sible solutions to various problems which may arise while becoming 
familiar with PIP. 

In addition to the File Utility Package, the PDP-11 Disk Operat- 
ing System software includes: 


DOS Monitor 


FORTRAN 
PAL-11R 
Edit-11 
0DT-11R 
Link- 11 
Libr-11 


IV 

Assembler 
Text Editor 
Debugging Program 
Linker 
Librarian 
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CHAPTER 1 


INTRODUCTION 


The File Utility Package performs useful file operations for the 
PDP-11 Disk Operating System (DOS). Examples of such operations are 
file transfers between devices, directory listings of disk or DEC- 
tape, deleting files, and renaming files. This program is named PIP 
(Peripheral Interchange Program) to be compatible with similar pro- 
grams on other DEC systems. 

The following list summarizes the major features provided by 

PIP. 

1. Allocate a contiguous file on DECtape or disk. 

2. List the directory of a disk or DECtape, printing only 
file names. 

3. List the directory of a disk or DECtape, printing file 
names, file size, creation date, and protection code. 

4. Delete a file or group of files. 

5. Change the protection on a file. 

6. Rename (change the name of) a file. 

7. Zero (initialize) a DECtape directory. 

8. Transfer a file or group of files from one device to 
another. 

9. Merge a group of input files into one new output file. 

A detailed description of each feature and its operation appears in 
either Chapter 3 or Chapter 4. 


1.1 CALLING AND EXITING 


PIP is called into core, like any other system program under DOS, 
using the RUN command. The reader should be familiar with certain 
DOS commands before attempting to use PIP; in particular, how the 
RUN command relates to the LOGIN, KILL, and FINISH commands. Briefly, 
you must be logged in before running PIP, and any previous program 
must be KILLed. 

The RUN command to call PIP into core is typed in response to 
the Monitor's dot (period) or dollar sign, which denotes DOS Monitor 
level . 
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For example: 


.LOGIN 1,1 
fRUN PIP 


to which PIP will respond with its version number and a number sign 
(#) • 


NOTE 

All command strings are terminated with the 
RETURN key. 


When PIP prints a number sign, it is ready to receive a command 
string. After completing the command, PIP will print another number 
sign, allowing another command string to be typed. 


To exit from PIP, type CTRL/C (i.e., hold down the CTRL key 
while typing the C key) . This returns you to the Monitor. At this 
point you must type the KILL command before you RUN another program. 
For example, the printout might appear as: 


j^LOGIN 1,1 
$RUN PIP 
PIP V001A 
#LP : </DI 


# +c 

^KILL 
$RUN EDIT 


(log in with your UIC) 

(call PIP into core) 

(PIP identifies itself) 

(list directory on line printer) 

(directory would appear on the 
line printer) 

(CTRL/C to return to Monitor) 
(clear core for next program) 
(call Edit-11 into core) 


NOTE 

In the examples, we have underlined system program 
printout to distinguish it from user input which is 
not underlined. 
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CHAPTER 2 


COMMANDS 


All commands in PIP are processed by the DOS Command String Inter- 
preter (CSI) . This assures a uniform command language between the 
various system programs operating under DOS. This section of the 
manual will describe briefly the command language. The reader is 
referred to the DOS Monitor Handbook for a complete description of 
the CSI. 

2.1 COMMAND STRINGS 

The command string tells PIP which operation or group of operations 
to perform. For example, the command to transfer a file named 
ARB. PAL from DECtape unit 0 to the line printer would be: 

jfLP : <DT0 : ARB . PAL 

Commands are always typed in response to the number sign (#). 

Since PIP can perform a large variety of operations, the com- 
mands to select the appropriate operation vary. Some operations 
require two sets of information: one set to describe the output 
and one set to describe the input. As illustrated in the examples, 
the input and output are separated from each other by the left angle 
bracket ( <) . For example, the following command will list a DECtape 
directory on the line printer. 

JLP : <DT0 : /DI 

There are some operations which need only the input information. 

For example, to zero (initialize) a new DECtape one need only type: 

#DT0 : / ZERO 

As you can see there is no need to specify the < symbol in such a 
case. 


Commands can consist of a large number of files, limited only 
by the length of a teleprinter line. To transfer files A, B, C, D, 
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E, and F from disk to DECtape, one could type: 


J-DT0 : < A , B , C , D , E , F 

To transfer a file ARB. PAL from user [200,200]'s disk area to 
DECtape unit 0 in formatted binary mode, one would type: 

#DT0f :< ARB . PAL [200,200] /FB 

The general format of a command string is: 

dev: f ilnam. ext [uic] /swl : vl : v2 : . . . vn/sw2 : vl : v2 : . . . 

Each element of a command string is explained below. In the descrip- 
tions that follow, the asterisk (*) character will be mentioned. 

Its usage is fully described in Section 3.1.5. For the interim, the 
asterisk represents "all". For example, 

* . PAL 

means all file names with an extension of PAL. 

.1.1 Device Specification 


The device specification, dev:, consists of two letters (listed 
below) , followed by one or more octal digits when required to speci- 
fy one of multiple units, followed by a colon. The standard device 
specifications are listed below, where n represents the unit number. 


dev 


Device 


DF: Disk, fixed head 

DKn : Disk cartridge (RK11) unit n 

DTn: DECtape unit n 

KB: Keyboard (teleprinter) 

LP : Line printer 

MTn : Magnetic tape unit n 

PP : High-speed paper tape punch 

PR: High-speed paper tape reader 

PT: Low-speed (teleprinter) paper tape reader/punch 


The unit designator (n) is required for multiple devices of the same 
type, e.g., two DECtapes would be DTI: and DT2 : . 


When a device is not specified in a command string, the current 
device is assumed to be the last device specified if there was one. 
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otherwise, the system disk is assumed. When no unit number is indi- 
cated for the device, unit 0 is assumed. 

2.1.2 Filename Specification 

When required, the filename specification, filnam, consists of from 
one to six letters or digits, or an asterisk; all characters in excess 
of six are ignored. The asterisk can be used to represent all file- 
names . 

2.1.3 Filename Extension Specification 

When required, the filename extension specification, .ext, consists 
of a period followed by from one to three letters or digits, or an 
asterisk, which represents all extensions of a named file. 

2.1.4 User Identification Code Specification 

When required, the user identification code, [uic] , consists of a 
pair of octal numbers separated by a comma and surrounded by square 
brackets. (The left and right square brackets are typed using 
SHIFT/K and SHIFT/M respectively.) The left number specifies the 
user group and the right number specifies the user within the group. 

When a UIC does not appear in a command string, the UIC of the 
user specified with the DOS LOGIN command is assumed. 

2.1.5 Switch Specification 

When required, the switch specification, /swl:..., consists of a 
slash followed by one or more letters, and optionally followed by a 
value specification of octal or decimal digits separated from the 
switch name by a colon. Switch names can be of any length; however, 
only the first two characters are ever used. If a switch is unique 
with one character, only that character needs to be typed. 

2.2 SWITCHES 


PIP's non-transfer operations are selected by use of switches, and 
are entered into the command string by preceding the switch with a 
slash. If more than one switch is used, each is still preceded by 
a slash. 
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A summary of PIP's switch options is listed below: 


Switch 

Name 

Operation 

/AL 

Allocate 

Allocate a contiguous file 

/BR 

Brief Directory 

List only filenames and extensions 
of a directory 

/CO 

Contiguous 

Treat the file as contiguous 

/DE 

Delete 

Delete the file 

/DI 

Directory 

List the entire directory, i.e., 
filenames and extensions, file size 
creation date, and protection code. 

/EN 

Enter 

Enter the User Identification Code 
(UIC) in the Master File Directory 
(MFD) 

/FA 

Formatted ASCII 

Transfer file in formatted ASCII 
mode 

/FB 

Formatted Binary 

Transfer file in formatted binary 
mode 

/PR 

Protect 

Change protection on the file 

/RE 

Ren ame 

Rename the file 

/UN 

Unlock 

Unlock the User File Directory 
( UFD) to recover the file 

/ZE 

Zero 

Zero the DECtape directory 


All switches must be typed as the last part of the file speci- 
fier, that is, they cannot appear before the filename on which the 
switch is to operate. Some options require a numeric value to be 
associated with the switch. For example: 


/PR 


is the switch to change the file protection code. The new protec- 
tion code would follow and be separated from /PR by a colon. For 
example, a protection change might be written as: 

#DT0: ABC/PR: 155 

which would change the protection code of file ABC on DECtape unit 0 
from whatever it was before to code 155. 


PIP's switch options can be grouped into two categories: action 
switches and qualifying switches, as explained below. 



2.2.1 Action Switches 


Action switches are generally associated with some recognizable opera- 
tion or action. Only one action switch can be used in any one com- 
mand string. The action switches are: 


ALLOCATE 

BRIEF 

DELETE 

DIRECTORY 


ENTER 

PROTECT 

RENAME 

UNLOCK 


2.2.2 Qualifying Switches 

Qualifying switches are used in conjunction with other switches, and 
are generally used to make a distinction which is otherwise not ob- 
vious. Any number of qualifying switches can be used in a single 
command string. The qualifying switches are: 


CONTIGUOUS 

ZERO 


FB (Formatted Binary) 
FA (Formatted ASCII) 




CHAPTER 3 


FILE HANDLING 


3 . 1 FILE TRANSFERS 

The transferring of files between devices is one of PIP's primary 
functions. PIP uses the device independent features of DOS , and in 
the simplest case transfers files from one peripheral to another. 

For example, to list a file you would transfer a copy of the file to 
the line printer, as in: 

JLP : <DT0 : FILEl . PAL 


or 


#LP : <FILE 2 . PAL 

Note that in the second example above, FILE2 . PAL is assumed to be on 
the user's area of the disk, since the disk is the device assumed if 
none is specified. 

As another example, the following command will transfer the data 
on a tape from the paper tape reader and create a file named INPUT. TST. 

_# INPUT . TST <PR: 

The following command will duplicate a paper tape. 

#PP : <PR : 

There can be only one output file but there can be any number of input 
files (limited only by the teleprinter line length). For example, to 
save three files, ONE. PAL, TWO. PAL, and THREE. PAL, onto DECtape unit 
0 you would type: 

#DT0 : <ONE.PAL,TWO. PAL, THREE. PAL 

3.1.1 Combining Files 

When there are several input files involved in a transfer the files 
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may be transferred without combining, as all previous examples illus- 
trated, or they may be combined into one new output file. 

When no output filename is specified with the output device, the 
input files are copied without combining. 

When a filename is specified with the output device, all input 
files are combined to create the new output file. For example, to 
combine the three files, SUB1.FTN, SUB2.FTN, and SUB3.FTN, into one 
new file called SUBS.FTN, you would type: 

#SUBS . FTN <SUB1 . FTN , SUB2 . FTN , SUB3 . FTN 

As a more complicated example, consider the files above as existing 
in a variety of places; then: 

#_DT3 : SUBS . FTN<DTl : SUBl . FTN , DF : SUB 2 . FTN [50,50] ,DT1 :SUB3.FTN [1,1] 
illustrates the type of syntax one could use. 

3.1.2 Modes During Transfers 

Files can be created with a variety of modes under DOS. Generally, 
files are either formatted or unformatted, either ASCII or binary. 
Formatted generally means that control and checksum information is 
carried along with the data so the integrity of the file can be as- 
sured during usage. Unformatted means that this extra information is 
not present. In binary mode a full byte of information is always 
transmitted whereas in ASCII mode generally only seven bits of the 
byte are passed. 

PIP makes no assumptions about the creation mode of any files it 
transmits. Consequently, the mode assumed for all transfers is unfor- 
matted binary unless specified otherwise. This means that formatted 
files will be transmitted with no benefit of the checksum feature that 
is available from DOS. It also means, in the case of paper tape, that 
blank frames, leader and trailer are all transmitted as data. This 
makes files transferred from the paper tape reader to the disk to be 
larger than necessary. 
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3.1.3 Formatted Modes 


Switches have been provided to override the assumed unformatted mode. 
The /FA (Formatted ASCII) and/FB (Formatted Binary) switches will 
cause the mode of the file associated with the switch to be the one 
specified. This applies to both input and output files. For example, 
to transfer the files ABC. DAT and ABC.TST in formatted binary mode, 
you would type : 

#DT0 : < ABC . DAT/FB , ABC - TST/FB 

In the case of the paper tape reader, the use of these switches would 
guard against the case of putting the tape in the reader backwards, 
as in : 

J-SPRMAN . OBJ<PR: /FB 

Any attempt to transfer in a mode which the device cannot support will 
be fatal, as in: 

#LP : /FB<DT0 : ABC 

which will cause a Monitor error message to be printed. 

3.1.4 Transfers from Teleprinter 

Occasionally you may wish to transfer from the teleprinter to another 
device, as in: 

#PP : <KB : 

The above command is, of course, legal and characters typed will be 
output to the high-speed paper tape punch. To indicate end-of-file 
with such a command, i.e., to stop transferring to the punch, the DOS 
convention is to invoke the END command to signal end-of-file. In 
order to execute the command, you must be in Monitor mode. Consequent- 
ly, the sequence is: 

1C (CTRL/C was typed) 

_j_END PT (RETURN key) 

(LINE FEED key) 

The line feed is necessary in order to force control back to PIP after 
the END command is executed. PIP will return with a number sign (#) 
after the above sequence is completed. 

The same sequence is necessary when transferring from the low- 
speed paper tape reader. However, it is necessary to indicate end-of- 
file from the user's keyboard. For this purpose, the END PT command 
is given. If the user typed: 

#DF : FILEIN ,MAC<PT : 
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it would be necessary to type: 

iC (CTRL/C typed) 

.END PT (RETURN key) 

(LINE FEED key) 

after the tape has been read and the low-speed reader comes to a stop. 

3.1.5 Asterisk in Transfers 

The asterisk (*) , when used in a command string, provides a convenient 
means of transferring large numbers of related files. For example, to 
transfer all load modules from a DECtape to the disk, you could type: 

#DF : <DT0 : * . LDA 

The asterisk is interpreted to mean "all". In the example above, all 
files with an extension of LDA would be transferred (without combine 
ing) onto the disk. 

The asterisk can appear in the filename field, the extension 
field, or both fields. For example, the command: 

#DT0 : <FORTN . * 

would transfer all FORTN files, regardless of the extension (includ- 
ing the null extension), to DT0 : . The command: 

#DF : <DT0 : * . * 

would copy all files from DT0:onto the disk. 

There is no need to limit the asterisk to one file specifier. 

The command : 

#DF : <DT0 : * . PAL , DTl : * . PAL , DT 2 : * . PAL 

would transfer all files with extensions of PAL from DT0 : , DTl:, 
and DT2 : . 

3.1.6 Contiguous Files 

Contiguous files are handled by DOS « differently from the regular files, 
which are called linked files. Blocks of contiguous files are guaran- 
teed by DOS to be physically adjacent, whereas linked files are gener- 
ally separated by a minimum fixed distance (called the interleave 
factor) to take advantage of the rotational delay inherent in a disk. 
Contiguous files are generally used for random accessing of data, a 
feature which is grossly inefficient with linked files. 
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Unless specified, file transfers assume linked files and use the 
corresponding DOS functions to perform the action. When working with 
contiguous files it is necessary to identify which files are to be 
treated as contiguous. 

When /CO is encountered during output file processing, the file 
will be written as a contiguous file. If the file specified already 
exists, a fatal error will occur because DOS does not permit this. 

When combining and the named file does not exist, PIP will deter- 
mine the size of all the input files, allocate the space for the new 
file, and transfer all input files. 

When transferring files without combining, PIP will recognize 
the /CO switch associated with any input files and create the output 
file as contiguous. For example, to transfer one contiguous file you 
would type : 

#DT0 : < ABC . DAT /CO 

To merge two contiguous files you would type: 

#DT0 : /C0< ABC . DAT , DEF . DAT 
3.2 RENAMING FILES 

The RENAME switch is provided to allow the user a means of changing 
the name of a file. The general form of the command is: 

dev : FILE1/RE <dev : FILE 2 
which changes the name of FILE2 to FILEl. 

As before, if no device is specified, the disk is assumed. For 
example : 

#MAIN . OBJ /RE <TESTX. OBJ 
changes the name of TESTX.OBJ to MAIN. OBJ. 

When renaming, it is mandatory that the same device be used on 
either side of the < symbol. The following is illegal: 
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#DTj2f:FILEl <FILE2 


because the device for FILE2 was not specified, thus the disk is 
assumed. The operation would not be performed and an error message 
would be printed on the user's terminal. The command should be writ- 
ten as : 


£DT0 : FILEl <DTJZ( : FILE2 
3.3 DELETING FILES 


The DELETE switch is provided to allow the user a means of deleting 
one or more files. The simple form of the command is: 

dev: f ile/DE 

For example, the command: 

#DT0 : MAIN . LDA/DE 

would delete the file MAIN. LDA from DT0 : . 

A number of files can be deleted by specifying a sequence of 
file names before the DELETE switch. For example, the command: 

#MAIN1 , DTI : MAIN 2 . OBJ , DT2 : MAIN2 . PAL/DE 

would delete all three files. 

The DELETE switch supports the asterisk in the filename or ex- 
tension fields of file specifications. The asterisk is interpreted 
as "all", as in *.PAL meaning all files with an extension of PAL. 

To delete all files with an extension of LDA from a DECtape, you 
would type: 

JDT1 : * . LDA/DE 

To delete all files from the disk you would type: 

#*. */DE 

To delete all files from a DECtape, it is recommended that you use the 
ZERO switch since that operation is much faster. 
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3.4 ALLOCATING CONTIGUOUS FILES 


The ALLOCATE switch provides a means of allocating space for a con- 
tiguous file. This option requires a filename and a value, which is 
the number of 64-word decimal blocks to allocate on the specified 
device. For example: 

£DF:FILE/AL:10 

would allocate 640 (or 10 times 64) contiguous words of file storage 
on the disk. The ALLOCATE switch works for both disk and DECtape . 

3 . 5 PROTECTING FILES 

The PROTECT switch is provided to allow the user a means of changing 
the protection of a file. 

The protection code is specified as an octal value argument to 
the switch and is treated as three fields corresponding to owner, 
user group, and all others. Each field is assigned an octal digit 
as described below. 


7 

1 6 

5 ! 

1 4 ■ 

3 

1 2 

1 

0 


Owner User Group All others 


Owner: Bit 6=1= Owner cannot write on or delete the file. 

This is a safeguard to prevent inadver- 
tent deletion or over-writing. 


Bit 7=1= Protect the 
on FINISH. 

User group and all others : 


Code Delete 


0 yes 

1 

2 or 3 
4 or 5 
6 or 1 


file from automatic deletion 


Function 


Write 

Read 

Run 

yes 

yes 

yes 

yes 

yes 

yes 


yes 

yes 



yes 


NOTE 

Yes indicates that the operation is allowed. 

For example, if a file belongs to user [23,10], 
a protection code of 3 will allow user [12,4] 
to read or run but not delete or write on it. 
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The general form of this command is: 


dev: fi 1/PR: value 


such as 


#FILE 3/PR: 355 

which changes the protection code of FILE3 to 355. The protection 
switch works for DECtape as well as disk, as in: 

#DT0: FILE 4/PR: 155 

3.6 RECOVERING FILES 

There are a number of infrequent ways in which a file can be left in 
a state which makes it inaccessible for subsequent processing. For 
example, if a file is open and a system crash (hardware or software) 
occurs causing the Monitor to be reloaded, the file will likely be 
left in an inaccessible state. 

Files which are declared inaccessible by DOS will likely have 
up to three things wrong with them: 

1. The LOCK bit in the UFD entry for this file will be set. 

2. The USAGE COUNT in the UFD entry for this file will be 
invalid. 

3. Some blocks allocated for this file may not have been 
marked off in the permanent bit map. 

PIP provides a partial solution to this problem with the UNLOCK switch. 
The function of this switch is to restore the Lock and Usage Count 
fields so that the file can be read. It does not make an attempt to 
mark any blocks in the bit map as occupied. 

The sequence for recovery is to use the UNLOCK switch, such as: 

ji_RUN PIP 

JDF: FILE. OLD/UN 

which allows the file to be accessed. 

In order to prevent the blocks from being overwritten, the file 
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should now be transferred to another file name, such as: 


#DF: FILE. NEW <FILE . OLD 

which will copy the old file and guarantee that it is in the proper 
state. The old file should then be deleted, such as: 

|DF: FILE. OLD/DE 


and the latest file can be renamed, if desired, such as: 

#DF: FILE. NAM/ RE <FILE . NEW 

Depending upon the state of the file, it may become impossible 
to transfer the file onto a backup file because erroneous data in the 
link words will make the chain never-ending or will link the file into 
unknown portions of the file system. In this case, it is suggested 
that you edit the file, searching for the end of the good data. Once 
this point has been found, write out the entire last buffer and close 
the new output file with the EF command to Edit-11. Since under this 
circumstance the file has bad links, any delete operation would almost 
surely be disastrous to a portion of the disk. The file containing 
erroneous data should be renamed to some uncommon name and left as it 
is, until the disk is reinitialized. 
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CHAPTER 4 


DIRECTORY HANDLING 


A significant number of PIP's features center around the manipulation 
of files within directories and of the directories themselves. 

4. 1 ENTERING USER IDENTIFICATION INTO DIRECTORY 

The User Identification Code (UIC) must appear in the Master File 
Directory (MFD) before a user is able to create his own files on the 
disk or DECtape. This code is generally entered into the MFD by using 
the ENTER option in PIP, although the system building program will 
create a few fundamental User File Directories (UFDs) . 

The UIC of the current user of the system is passed to DOS by the 
LOGIN command. For example: 

JLOGIN 10,11 

will set the current UIC to [10,11J. 

The UIC of the current user is obtained from DOS and written into 
a spare slot in the MFD. If no spare slots exist in the MFD, PIP will 
print a fatal error message, and no attempt will be made to extend the 
MFD. The recommended sequence is then: 

^LOGIN uic 
$RUN PIP 
JDF : /EN 

This procedure is not always necessary for DECtapes because the ZERO 
switch will enter the UIC of the current user when the directory is 
initialized. 

If a user other than the one originally zeroing the DECtape wishes 
to access files on the tape, he must enter his UIC on the DECtape or 
explicitly reference the UIC field during each reference. 

4.2 DIRECTORY LISTINGS 

The directory of a file-structured device may be output to any device. 
The information listed for a directory is some subset of all the in- 
formation contained within the UFD entry for each file. 

The directory switch prints a title line and then lists the file- 
name, the extension, the number of blocks (decimal), the creation date, 
and the protection code. It also summarizes some figures concerning 
the files in the directory. 
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The directory switch can assume either the multiple-file or single 
file syntax. For examples: 


#LP:/DI<DT0: , DTI: 

outputs the directories for DT0 : and DTI: onto the line printer. 

#KB:/DI<DT0 
° r #DT0:/DI 

outputs the directory of DT0 : onto the user's terminal. 


#KB : <DI 


or 


£/ DI 


outputs the directory of DF : onto the user's terminal. 


Notice that in the last few examples a convenient notation was 
allowed which assumed the user's teleprinter, if no output device was 
specified. This form is legal only if " < " is not present in the 
command . 


Sample disk and DECtape directories are shown below. Notice that 
the summaries are different, depending upon whether disk or DECtape is 
used. 


DIRECTORY DF0 : [1,1] 


file size ( 


MONLIB 

956 

01- JAN- 70 

<377 > <r 

PIP 


61 

01- JAN- 70 

<233 > 

PIPX 


73 

01- JAN-70 

<2 3 3 > 

EDIT 


61 

01- JAN- 70 

<233 > 

PAL 


114 

01- JAN- 70 

<23 3 > 

ODT 

.OBJ 

53 

01-JAN-70 

<233 > 

LINK 


77 

01-JAN-70 

<233 > 

LIBRA 


37 

01-JAN-70 

<233 > 

COPY 


13 

01- JAN- 70 

<233 > 

DOS 

.SI 

17 

01- JAN- 70 

<233 > 

R 


1 

01- JAN- 70 

<23 3 > 

DOS 

. S2 

14 

01- JAN-70 

<2 33 > 

DOS 

.02 

9 

01-JAN-70 

<23 3 > 

DOS 

• S3 

14 

01- JAN-70 

<23 3 > 

DOS 

.OR 

9 

01- JAN-70 

<23 3 > 

DOS 

. S 4 

14 

01-JAN-70 

<233 > 

DOS 

.04 

9 

01- JAN- 70 

<233 > 

PALI 


13 

01- JAN- 70 

<233 > 

PAL2 


336 

01- JAN- 70 

<233 > 

PAL3 


454 

01- JAN- 70 

<233 > 

PAL4 


450 

01- JAN- 70 

<233 > 

PAL5 


199 

01- JAN- 70 

<233 > 

EDITA 


397 

01-JAN-70 

<23 3 > 

EDITl 


138 

01-JAN-70 

<233 > 

EDIT2 


90 

01- JAN- 70 

<233 > 

EDIT3 


106 

01- JAN- 70 

<23 3 > 

EDIT4 


85 

01- JAN- 70 

<233 > 

EDIT5 


13 

01- JAN- 70 

t 

<23 3 > 

TOTL 

TOTL 

BLKS : 
FILES : 

3813 

28 

creation 

l date 


decimal blocks) 
protection code 
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DIRECTORY DT0 : [1,1] 


SYSLOD 

• SYS 

31 

23-MAR- 71 

<377 > 

MONLIB 

.SYS 

80 

01-APR- 71 

<333 > 

PIP 


15 

01-APR- 71 

<233 > 

PIPX 

. LDA 

18 

01- APR- 71 

<23 3 > 

EDIT 

. LDA 

15 

01-APR-71 

<23 3 > 

PAL. 

.LDA 

28 

01- APR- 71 

<23 3 > 

ODT 

.OBJ 

13 

01- APR- 71 

<23 3 > 

LINK 

.LDA 

19 

01-APR- 71 

<23 3 > 

LIBRA 

.LDA 

9 

01-APR- 71 

<23 3 > 

COPY 12 

• LDA 

3 

26-MAR-71 

<233 > 


FREE BLKS : 329 

FREE FILES: 46 


A subset of the directory listing is available with the BRIEF 
switch. This switch prints the title line, then lists only the file- 
name and extension followed by the summary data. For example, 

£DT0:/BR 

will give a brief directory listing for DT0 : , while 
i/BR 

will give a brief directory listing for the user's disk area. 


Sample disk and DECtape directories are shown below: 

DIRECTORY DF0 : [1,1] 

MONLIB 

PIP 

PIPX 

EDIT 

PAL 

ODT . OBJ 
LINK 
LIBRA 
COPY 

DOS .SI 
R 

DOS . S2 

DOS .03 

DOS . S 3 

DOS . OR 

DOS . S4 

DOS .04 

PALI 

PAL2 

PAL3 

PAL4 

PAL5 

EDITA 

EDITl 

EDIT2 

EDIT3 

EDIT4 

EDIT5 

TOTL BLKS: 3813 
TOTL FILES: 28 
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DIRECTORY DT0: 11,13 


SYSLOD 

.SYS 

MONLIB 

.SYS 

PIP 

. LDA 

PIPX 

. LDA 

EDIT 

.LDA 

PAL 

.LDA 

ODT 

.OBJ 

LINK 

.LDA 

LIBRA 

.LDA 

C0PY12 

• LDA 

FREE BLKS: 
FREE FILES 


4 . 3 ASTERISK IN DIRECTORY LISTINGS 

The asterisk (*) feature for filenames and extensions works for 
directory listings, both normal and brief form. For example, the 
command 

#_* . PAL/BR 

gives a brief directory listing for all files on the user's disk area 
with an extension of PAL. The asterisk can appear in the filename 
field, the extension field, or both. In addition, groups of file 
specifiers can be arranged to provide sequential listings, as in 

£DT 0 : * . MAC , DF : FORTN . */DI 

4.4 DECTAPE ZEROING 

In order to initialize a new DECtape with the basic file structure 
information required by the DOS Monitor, the ZERO switch is provided. 

This switch works only on DECtape and performs no action for other 
devices . 

The function creates the permanent bit maps, the file bit maps, 
the MFD, and a UFD for the user currently running this program. 

This switch may be used either by itself, as in: 

#DT0:/ZE 

or in combination with other switches, as in: 

#DTj2f :ONE/ZE<DTl:A,B,C 

which zeroes 'DT0 : first, then creates file ONE on DTj? : by concatenating 
files A, B, and C from DTI : . When used in combination with other 
switches, ZERO is performed before any other implied actions. 
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CHAPTER 5 


ERROR MESSAGES 


Error messages conform to the standard for error handling as defined 
in the DOS Monitor handbook. Errors will be of the form 

Sxxx 

where the S indicates a system program error. 

Error messages unique to PIP are listed below. Consult the DOS 
Monitor handbook for a complete description of all error messages. 


Error Message 

Reason 


S 203 

Too many switches or an illegal 

switch 

S204 

Too many output specifiers. 


S205 

Too many input files 


S231 

Illegal command; file-structured device 

S232 

More than one action switch specified. 

S233 

UIC not in MFD. 


S23 4 

No file name where one is required. 

S235 

No files exist in UFD. 


S236 

Operation applicable to DECtape 

only. 

S237 

File not found. 


S240 

Insufficient space for file. 


S241 

MFD is full. 


S242 

Meaningless command; no action 

taken . 


required . 
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>LUME 2: #24 


December 27, 1971 


)P-11 PIP ALL VERSIONS THRU 5A 

:oblem with files Inadvertently named UAB 


EP will not allow the use of an **' on the output side of a 
Dinmand in TRANSFER or RENAME. Attempts to use the ’** will 
suit in a file called UAB in the field corresponding to the 
1 in the command. 

o get rid of uab file names, do the following: 

Rename the file using ’ * ' in the field (s) corresponding 
to the UAB 

eg. 

• uAB . UAB 

#F 00 <£*.* /re (the file will then be renamed FQ0.5 




APPENDIX A 


SUMMARIES 


Switch 

Name 

Example 

Operation 

/AL 

Allocate 

#_DF : FILE/ AL : 1,0 

640 (10 x 64) contiguous words 
of file storage is allocated 
on disk. 

/BR 

Brief 

Directory 

#DT0:/BR 

List all filenames and exten- 
sions of directory for ■ DEC- 
tape 0 onto the user Teletype. 

/CO 

Contiguous 

£DT0 : <ABC/CO 

Transfer file ABC as contigu- 
ous file from disk to DECtape 

0. 



#JDT0 : /C0< ABC , DEF 

Merge files ABC and DEF as 
two contiguous files. 

/DE 

Delete 

#MAIN/DE 

Delete file MAIN from disk. 



£DT0 : ABC , DTI : DEF/DE 

Delete files ABC and DEF from 
DECtapes 0 and 1 respectively. 

/DI 

Directory 

£DT0 : /DI 

List all filenames, extensions 
size, creation date, and pro- 
tection codes of directory 
for DECtape 0 onto the user's 
Teletype . 

/EN 

Enter 

_# DF : /EN 

Enter current user's UIC in 

MFD on disk. 

/FA 

Formatted 

ASCII 

#LP : /FA<DT0 : ABC 

Copy file ABC from DECtape 0 
to line printer in formatted 
ASCII mode. 

/FB 

Formatted 

Binary 

£DT0 : <ABC/FB 

Copy file ABC from disk to 
DECtape 0 in formatted binary 
mode. 

/PR 

Protect 

fABC/PR: 355 

Change protection code of 
disk file ABC to 355. 

/RE 

Rename 

£ABC/RE<DEF 

Rename disk file DEF to ABC. 



JI)T0 : GHI/RE<DT0 : JKL 

Rename DECtape 0 file JKL to 
GHI . 

/UN 

Unlock 

£DF : FILE. OLD/UN 

Unlock FILE. OLD after a sys- 
tem failure so that FILE. OLD 
can be accessed. 

/ZE 

Zero 

#DT0:/ZE 

Erase all files from directory 
of DECtape 0. 

/Ffl 

f y f c e 

i? / i 

. j j 3 / ** 

* OK /F JL 

■F 4-r-ec- bl ocK^. 
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Device Specifications 


dev Device 

DF: Disk, fixed head 

DKn: Disk cartridge (RKll) 

DTn: DECtape unit n 

KB: Keyboard (teleprinter) 

LP : Line printer 

MTn : Magnetic tape unit n 

PP : High-speed paper tape punch 

PR: High-speed paper tape reader 

PT: Low-speed (teleprinter) paper tape reader/punch 
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APPENDIX B 


HELPFUI HINTS 


There are a few things which are obvious to experienced DOS users, 
but the beginner often has to learn them empirically. This section 
is meant to help the beginner avoid some common pitfalls. 

1. If you are having difficulty running PIP, make sure 
that : 

a. you are logged in, 

b. you did a KILL command after running a pre- 
vious program, 

c. the load module (PIP.LDA) is on the disk, or, 

d. you are accessing the proper UIC field on the 
DECtape, if attempting to run from DECtape , 
i.e., you should be logged in under the same 
UIC as shown on the directory of the DECtape. 

2. If you are having difficulty accessing a DECtape file 
which you are positive is there, you are probably logged 
in under a different UIC than appears on the DECtape. 

In this case, either: 

a. Explicitly specify the UIC in the command, 

b. FINISH and LOGIN under the proper number, or, 

c. ENTER your UIC on the DECtape (see Section 4.1). 

3. If you are having difficulty transferring to the line 
printer, make sure the printer is on-line; set the 
switch to ON LINE. 

4. If you are having difficulty reading a file and there 
has recently been a software or hardware crash, read 
Section 3.6, Recovering Files. 

5. If you continue to get file structure errors on output 
files, you are probably trying to create a file which 
already exists. DOS does not allow this, so delete 
the file first. 
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If you are logged in for the very first time and 
cannot create any files, it is because you have no 
User File Directory (UFD) in the Master File Direc- 
tory (MFD). To create one, Log in, call PIP and 
type: 


£ DF : /EN 

and you are all set. 

7. If you cannot write anything on a DECtape even 

though the write switch is on, it is likely that: 

a. the DECtape belongs to someone else and he 
does not want you to write on it accidentally, 
or, 

b. the tape has not been certified. 

If the DECtape does belong to someone else, you may 
still write on it by using the ENTER switch to put 
your directory on the DECtape, as in: 

£DT0 : /EN 

Uncertified DECtapes can be certified using a di- 
agnostic program supplied with the maintenance pro- 
gram. 
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MAGTAPE OPERATIONS 


This appendix describes those changes made to V004A PIP to incorporate 
several industry compatible magtape operations. The version of PIP 
described is distributed as VffffSA PIP. 


C.l GENERAL MAGTAPE INFORMATION 

Industry compatible magnetic tape is supported by PIP for the following 
operations: 



#MT1:/DI 

|MTJ3:/BR 


IMTl : FIL£< DT2 : ABC 

#MT : MERGE< ABC , DTjZ : FACT ,MT1 : DATA 



Transfer and directory operations include all asterisk features 
used for other file-structured devices. In addition, on magtape it is 
possible to say: 

#MT1: [*,*j/DI 
or 

#MT1: [*,*]/BR 

This allows the user to obtain a complete listing of all files •on'the 
specified magtape (s). When this option is used, the UIC specification 
is printed as part of the file information. For example: 


C-l 


7 ri»ijw . i » J 1*111. I r J/Ui 


DIRECTORY MT0 : 

[* 

,*] 


♦ 

13-SEP-71 





DDT .PAL 

59 

ll-SEP-71 

<233> 

(200,200] 

EDIT ‘ 

14 

13-SEP-71 

<233> 

11,1] 

TOTL BLKS : 

73 ' 




TOTL FILES: 

2 



‘ 

DIRECTORY MT2: 

t* 

,*} 



13-SEP-71 





ODT .OBJ 

13 

13-SEP-71 

<233> 

HrlJ 

TOTL BLKS: 

13 




TOTL FILES: 

1 





> REWIND 

s Rewind switch is applicable only to magtape units. This switch 
lses the tape to be wound back on its original reel. Following this 
:ion the magtape unitCs) can still be addressed. For example: 

»MT1 : /RW 

#MT1: ,MT2:/RW 
t acceptable commands. 

I REWIND and UNLOAD 

Rewind and Unload switch is applicable only to magtape units. This 
.tch causes the tape to be wound back on its original reel and the 
ftape unit to be switched off-line. Following this option the MAG- 
>e unitCs) cannot be addressed for further processing. For example: 

#MT:/RU 
#MT2: ,MT3:/RU 

4 ZERO 

It is mandatory that a magtape be zeroed before use. The /ZE 
itch writes two end-of-file marks on the tape so that it can be 
ndled correctly by DOS. 
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INDEX 


Accessing files, 4-1 
Action switches, 2-5 
ALLOCATE switch, 3-7 
Allocating contiguous files, 3-7 
ASCII mode, 3-2 
Asterisk (•*) usage, 2-2, 3-4, 
3-6, 4-4 


Binary mode, 3-2 
Blank frames, 3-2 
BRIEF switch, 4-3 


Calling PIP, 1-1 
Changing file name, 3-5 
/CO (contiguous) switch, 3-5 
Combining files, 3-1 
Command 

language, 2-1 

String Interpreter (CSI) , 2-1 

strings, 2-1 
Commands 
END, 3-3 
FINISH, 1-1 
KILL, 1-1, 1-2, B-l 
LOGIN, 1-1, 4-1 

RUN, 1-1 

Contiguous files, 3-4 
allocation, 3-7 
CTRL/C, 1-2 


DECtape 

directory sample, 4-2 
initializing or zeroing, 2-1, 4-4 
DELETE switch, 3-6 
Deleting files, 3-6 
Device specification, 2-2, A-2 
Directories, sample of disk and 
DECtape, 4-2 
Directory listings, 4-1 
subset, 4-3 

Disk directory sample, 4-2 
Dollar sign ($) usage, 1-1 
Dot or period (.) usage, 1-1 
Duplicating paper tape, 3-1 


END command, 3-3 
End-of-file, 3-3 

Entering User Identification into 
directory, 4-1 
Error messages, 4-1, 5-1 
monitor, 3-3 

see also Helpful Hints, B-l 
Exiting from PIP, 1-2 
Extension PAL, 2-2 


/FA (Formatted ASCII) switch, 3-3 
/FB (Formatted Binary) switch, 3-3 
Features of PIP, 1-1 
File 

handling, 3-1 
protection, 3-7 
recovery, 3-8 
transfers, 3-1 
Filename 

extension, 2-3 
specification, 2-3 
FINISH command, 1-1 
Formatted 
files, 3-2 
modes, 3-3 


Initializing 

DECtape, 2-1, 4-4 
file directory, 4-1 
Interleave factor, 3-4 


KILL command, 1-1, 1-2, B-l 


Leader tape, 3-2 

Left angle bracket ( < ) usage, 2-1, 
4-2 

Linked files, 3-4 

LOCK bit, 3-8 

LOGIN command, 1-1, 4-1 


Master File Directory (MFD) , 4-1 

Modes during transfers, 3-2 


Number sign (#) , 1-2, 2-1 


Overwriting, 3-8 


PAL extension, 2-2 
Period or dot (.) usage, 1-1 
Permanent bit map, 3-8 
Protect switch, 3-7 
Protecting files, 3-7 
Protection code, 3-7 
Protection switch, 3-8 
/PR (change file protection code) 
switch, 2-4 


Qualifying switches, 2-5 
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Random accessing, 3-4 
Recovering files, 3-8 
RENAME switch, 3-5 
Renaming files, 3-5 
RETURN key, 1-2 
RUN command, 1-1 


Sample directories, disk and DEC- 
tape, 4-2 

Slash ( / ) usage, 2-3 
Square bracket usage, 2-3 
Summaries 

device specifications, A-2 
switch, A-l 
switch options, 2-4 
Switch names, 2-3 
Switches, 2-3, 3-3 
action, 2-5 
ALLOCATE, 3-7 
BRIEF, 4-3 
/CO, 3-5 
DELETE, 3-6 
/FA, 3-3 
/FB, 3-3 

options summary, 2-4 
/PR, 2-4 
PROTECT, 3-7 
qualifying, 2-5 
RENAME, 3-5 
summary, A-l 
UNLOCK, 3-8 
ZERO, 3-6, 4-1 


Trailer tape, 3-2 
Transfer modes, 3-2 
Transferring 

files, 2-1, 2-2 
files to line printer, 3-1 
files from low speed paper tape 
reader, 3-3 

files from paper tape reader, 3-1 
related files, 3-4 
several input files, 3-1 
files from teleprinter, 3-3 


UNLOCK switch, 308 
USAGE COUNT, 3-8 
Unformatted files, 3-2 
User Identification Code 
(UIC) , 2-3, 4-1 

User identification entry, 4-1, 4-2 


ZERO switch, 3-6, 4-1, 4-4 
Zeroing DECtape, 2-1, 4-4 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Program Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 
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of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 
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